[[:groupes:ubuntu-fr-webteam:tester_les_outils]]

====== Install doc local ======

  *Install virtualbox
  *install Lubuntu desktop
  *Addons sur guest pour partage fichier et plein ecran
  * Update/upgrade

  *Pour faire marcher [[https://www.dokuwiki.org/requirements|dokuwiki]] il faut un serveur qui supporte php. [[:Lighttpd]] semble plus léger qu'apache. Modifier les fichiers //10-fastgi.conf// et //15-fastcgi-php.conf// dans **/etc/lighttpd/conf-avalaible** (faire save avant) comme indiqué sur la page. Recharger les modules et relancer lighttpd
  *Installation minimale de [[:php]]. (7.0) . FIXME Ajouter le [[:services|service]] //php7.0-fpm// au démarrage du système.<code>sudo systemctl enable php7.0-fpm.service</code>
  * Installer [[:git ]] 

<note important>Pour la suite, les fichiers seront  placés dans ''/var/www/html/ubuntu-fr'' et non ''/var/www/ubuntu-fr'' ou alors définir dans **/etc/lighttpd/lighttpd.conf** le bon "document-root"
<file>server.document-root        = "/var/www/html/"</file>
</note>

<note tip>
  * voir plus tard si ça marche dans un dossier Home avec peut-être des ln. Pour le moment tout dans /var/www/html/ubuntu-fr.\\ Avec l'option $conf['savedir'] = './data'; ça devrait le faire si data est un lien symbolique vers /lieu/des/datas et les bon droits.
</note>
  * À minima il faudra ensuite évidemment les fichiers de la //doc// accessible depuis [[https://launchpad.net/ubuntu-fr-doc|sa page launchpad]] <code>
git clone https://git.launchpad.net/ubuntu-fr-doc</code>et le dossier //data// (tar.bz du dictateur de la doc -cf framateam)
<note>Vous pouvez-ajoutez [[https://launchpad.net/ubuntu-fr-guide|Guide]] et [[https://launchpad.net/ubuntu-fr-tour|Tour]] mais pour avoir une installation minimal de la doc ce n'est pas utile. Attention cependant à garder en tête que certains liens peuvent ne pas marcher</note>

  * Modifiez les [[:droits]] <code>sudo chown -R www-data:www-data /var/www/html/ubuntu-fr
sudo chmod -R ug+rw /var/www/html/ubuntu-fr</code>
  
Vous aurez l'arborescence finale comme suit
  * /var/www/html/ubuntu-fr/ubuntu-fr-doc/
    * bin
    * conf/
    * data/
    * inc/
    * lib/
    * vendor/
    * doku.php
    * index.php
    * .htaccess.dist

Pour la suite le **seul** fichier à modifier sera **conf/local.protected.php**. Il est prioritaire sur **local.php**, qui lui-même supplante **dokuwiki.php**.\\
Adaptez le par exemple comme ceci <file php local.protected.php>

<?php
/*
 * Paramètres de configuration propres à votre serveur de travail
 * Attention les options principales sont dans local.php qu'il ne faut pas modifier
 * Penser à le save avant une màj
*/

//Le fichier userscripts.js sert pour les bouton en mode édition (exemple modifier un fichier, installer un paquet)

//https://www.dokuwiki.org/fr:rewrite pour pas avoir doku.php?id=nompage
//https://www.dokuwiki.org/rewrite#discussion pour php
//0: pas de rewrite / 1:passe par lighttpd.conf/ 2:interne à dokuwiki
//dans local.php ->= 1 car rewrite fait sur le serveur. Risque 404-not found en localhost
// donc:
$conf['userewrite'] = 2;

//passer en dev sinon ???
$conf['is_dev'] = 1;

//Gestion du thème
// Choix du template
//$conf['template']    = 'adoradark';
//$conf['template']    = 'dokuwiki';

//Lieux du template (pas trouvé comment mettre en local donc usage des severs pour le template, sinon choisir au dessus dokuwiki
//$conf['tpl']['ubuntu-2010']['static_host'] = '//www-static.ubuntu-fr.org';

 //Reactive toutes les actions
$conf['disableactions']='';

//* Gestion de connexion utilisateur pour le serveur de DEV.
$conf['authtype']='authplain'; //pour la connexion sans la base du forum
//remplir users.auth.php en faisant un sha1 sur le net.
//par exemple le login+mdp y on été mis à testeur/testeur avec
//testeur:0dd3d8466da1d1b581d8b1036f24ef43d37c7974:Moi:moi@nawak.og:members

//pour être admin et pas simple user
$conf['superuser']= 'testeur';

// Suivi des modifications non nécessaires en DEV
$conf['notify'] = '';

</file>


Modifier **users.auth.php** <file>testeur:0dd3d8466da1d1b581d8b1036f24ef43d37c7974:Moi:moi@nawk.org:admin</file> SHA1 pour user testeur

=====  Erreurs =====
==== Page blanche ====
Mauvais réglage dans le local.protected.conf (oublie d'un ; ou usage d'un mauvais paramètre)
==== 403 ====
Vérifier la présence du dossier Data et ses droits (www-data)

==== 404:Not Found ====
Passer le userewrite à 0 dans local.protected.php et vérifier le server.directory.root

==== Access Denied ====
conf du serveur?

==== Problème de template ====
Vous avez le template mais pas le contenu de la page. Modifier pour avoir la valeur <file>$conf['template'] = 'dokuwiki';
</file>

===== But =====
  * voir difficulté d'installation 
  * voir installation et test de plugin
  * test export
